When a SAS Workflow Services 9.2 application contains an HttpRequestPolicy, execution of the HttpRequestPolicy can result in an HTTP failure. However, no notice of the failure is sent, and the administrator has no way to know that the HttpRequestPolicy is not operating as expected.

The Application Server or solution logs contain an error similar to this:

org.springframework.remoting.RemoteAccessException: Could not access HTTP invoker remote service at 
 [http://10.11.12.13:80/SASWorkflowServices/remote/workflowEngineService]; nested exception is  
 org.apache.commons.httpclient.HttpException: Did not receive successful HTTP response: status code = 404,
 status message = [Not Found] 

Click the Hot Fix tab in this note to access the hot fix for this issue.

After installing the hot fix, a "Workflow.SendAdminMail." configuration setting is available. If the Workflow.SendAdminMail property is defined with a value of true, then the HttpRequestPolicy engine sends an e-mail message when failures occur. Otherwise, no e-mail message is sent when failure occurs.

The Configuration Manager tab in SAS^® Management Console is a plug-in that you can use to view and modify application configuration attributes of a SAS application. You must use this plug-in to define the new property for the SAS Workflow Services application. Here are details for enabling this new configuration setting.

Follow these steps to modify the configuration settings for the SAS Workflow Services application.

• In SAS Management Console, expand the Configuration Manager under the Application Management node.
• Right-click Workflow Services 9.2 and select Properties from the pop-up menu.
• Select the Advanced Tab.
• Create a new property named Workflow.SendAdminMail. It must have a value of true.
• Click OK to accept changes.

The SAS Workflow Services application inherits settings from the SAS Application Infrastructure application. If you want to override these settings and use workflow-specific values, then you must first unlock the setting defined in SAS Application Infrastructure. Then, go to the SAS Workflow Services application configuration, and override the values.

1. Unlock the SAS Application Infrastructure configuration settings for the recipient of the administrative messages.
   • In the SAS Management Console, expand the Configuration Manager under the Application Management node.
   • Right-click SAS Application Infrastructure and select Properties from the pop-up menu.
   • Select the Settings Tab.
   • Highlight the Notifications setting.
   • Go down to Recipient of administrative messages and select the unlock icon.
   • Click OK to accept changes.
2. Update the SAS Workflow Services application configuration settings for the recipient of the administrative messages.
   • In the SAS Management Console, expand the Configuration Manager under the Application Management node.
   • Right-click Workflow Services 9.2 and select Properties from the pop-up menu.
   • Select the Settings Tab.
   • Highlight the Notifications setting.
   • Go down to Recipient of administrative messages and edit the values. Only those recipients listed here are used by the Workflow engine.
   • Click OK to accept changes.

Here is an example of an e-mail notification that is sent when an error return code is returned from an HTTP call.

-----Original Message-----
From: JQ.Programmer@sas.com [mailto:JQ.Programmer@sas.com]
Sent: Thursday, August 05, 2012 12:05 PM
To: John Q. Programmer
Subject: SAS Workflow HttpRequestPolicy Failure

A failure was encountered in the HttpRequestPolicy defined on process,
'HttpTest'.
The URL is http://t3120.na.sas.com:8080/abc.
The HTTP POST Status Code is 404.

Here is an example e-mail notification that is sent when an exception occurs during processing (including the exception message).

-----Original Message-----
From: JQ.Programmer@sas.com [mailto:JQ.Programmer@sas.com]
Sent: Thursday, August 05, 2012 12:08 PM
To: John Q. Programmer
Subject: SAS Workflow HttpRequestPolicy Failure

A failure was encountered in the HttpRequestPolicy defined on process,
'HttpTest'.
The URL is http://t3120.na.sas.com:8080/abc\\invalid/invalid\anotherRefernce.
The HTTP POST Status Code is 999.
Error message is,  Invalid uri '/abc\\invalid/invalid\anotherRefernce': escaped
absolute path not valid

Operating System and Release Information

A fix for this issue for SAS Middle Tier 9.2_M2 is available at: